Graphic Style Properties

Properties are on the Properties tab of the selected graphic style, grouped by category. They are emitted into the FO document, so the full-resolution generated image stays embedded in the PDF and the FO engine scales it at render time. Raster images honor these properties since 2026.1.

Content Width, Content Height (Advanced group)

A percentage or a length. A percentage is relative to the image's own (intrinsic) size, so 20% renders the full-resolution image at 20% of its natural dimensions. The default value, Scale down to fit, is a keyword rather than a size and does not resize the image.

Width, Height (Layout group)

An absolute box for the image, such as 1.25in. The image is scaled into that box with its aspect ratio preserved.

Note: These properties size raster images. Vector (SVG) images follow a separate sizing path in this format and are not affected by them.

When a graphic style carries both a Scale % value and a dimension property, the two mechanisms compose: Scale % resamples the bitmap first, and the dimension property then sizes that already-resampled image on the page. Dimension values are honored as authored, so a value larger than the image's natural size enlarges it, and a box wider than the body region overflows the page.